home *** CD-ROM | disk | FTP | other *** search
/ Mac Expert 1995 Winter / Mac Expert - Winter 95.iso / Les fichiers / Utilitaires divers / Images / Mac POV Utils 1.1 ƒ / POV-Utils Docs.Raw / Lissa / Lissa.Doc
Encoding:
Text File  |  1993-03-23  |  2.4 KB  |  53 lines  |  [TEXT/ttxt]
  1. Lissa, version 1.0
  2. Copyright 1992, esp Software, All Rights Reserved
  3. This software is FreeWare, not Public Domain!
  4.  
  5. Lissa is a special curve generator for the POV-Ray
  6. Utilities.  Lissajous curves are oscillating sine curves
  7. that generate interesting "basket-weave" patterns.   This
  8. program accepts command line parameters to customize some
  9. of its calculations, then generates a text file as output
  10. that contains a sequence of points along a 3-D lissajous
  11. trail.  The lissajous pattern is scaled to unit size, i.e.
  12. within the box from -1,-1,-1 to 1,1,1.  The output file
  13. format is for the Connect-the-Dots Smoother POV-Utility
  14. (CTDS).  This lissajous output file is intended to be run
  15. through the CTDS program, which will emit a POV-Ray scene
  16. data file for a continuous "tube" that describes the
  17. lissajous curve. This can then be rendered by POV-Ray.
  18.  
  19. The command line parameters are:
  20. lissajous -xX_FACTOR -yY_FACTOR -zZ_FACTOR -pMAX_POINTS -dCTDS_DIAM -tMAX_THETA -fOUTNAME
  21. Where:
  22. Name        Type    DefaultVal  Description
  23. ---------   ------  ----------  ----------------------
  24. X_FACTOR    int       3         X-Theta multiplier (-100 to 100)
  25. Y_FACTOR    int       5         Y-Theta multiplier (-100 to 100)
  26. Z_FACTOR    int       7         Z-Theta multiplier (-100 to 100)
  27. MAX_POINTS  int     100         total # of points to generate (2 to 1000)
  28. CTDS_DIAM   fp        0.1       diameter of tubes (0.001 to 1.0)*
  29. MAX_THETA   fp        1.0       scale factor of 2*pi to iterate to (0.1 to 10.0)**
  30. OUTNAME     str     stdout      text file name to create & write to (stdout if none)
  31.  
  32. *   Remember the Lissajous curve is within the bounds -1,-1,-1 to 1,1,1,
  33.     so a tube diameter of 0.1 is 1/10th the size of the curve area.
  34. **  The curve is usually traced through a single 360 degree sweep.  This
  35.     scale factor lets you change how far to go, by multiplying by
  36.     2*pi (or 360 degrees.)  So 0.5 would be 180 degrees, 1.0 is 360.
  37.  
  38. This program was originally written for the Macintosh under MPW C 3.2, but
  39. was intended to be very portable to other compilers and hardware platforms.
  40.  
  41. The source code is available from the author, and may be already posted on
  42. CompuServe and America Online.
  43.  
  44. For more information on this program, or if you have suggestions, bug-fixes,
  45. or porting fixes, please contact the author:
  46. Eduard [esp] Schwan
  47. AppleLink:    JL.MacTech
  48. CompuServe: 71513,2161
  49. Internet:       71513.2161@compuserve.com
  50. USMail:         1112 Oceanic Drive, Encinitas, Calif. 92024-4007
  51.  
  52. Have fun with it!  [esp]
  53.